package cn.ld.module.system.api.logger;

import cn.ld.framework.common.pojo.PageResult;
import cn.ld.module.system.api.logger.dto.OperateLogCreateInDTO;
import cn.ld.module.system.api.logger.dto.OperateLogPageInDTO;
import cn.ld.module.system.api.logger.dto.OperateLogOutDTO;
import jakarta.validation.Valid;
import org.springframework.scheduling.annotation.Async;

/**
 * 操作日志 API 接口
 *
 * @author 蓝盾
 */
public interface OperateLogApi {

    /**
     * 创建操作日志
     *
     * @param createInDTO 请求
     */
    void createOperateLog(@Valid OperateLogCreateInDTO createInDTO);

    /**
     * 【异步】创建操作日志
     *
     * @param createInDTO 请求
     */
    @Async
    default void createOperateLogAsync(OperateLogCreateInDTO createInDTO) {
        createOperateLog(createInDTO);
    }

    /**
     * 获取指定模块的指定数据的操作日志分页
     *
     * @param pageInDTO 请求
     * @return 操作日志分页
     */
    PageResult<OperateLogOutDTO> getOperateLogPage(OperateLogPageInDTO pageInDTO);

}
